package com.bean.config;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration //加载到配置文件中
@EnableSwagger2  //开启Swagger2
public class Swagger2Config {

    @Value("${swagger2.host:192.168.233.130}")
    private String swaggerHost;



// 配置了Swagger的Docket的bean实例
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .host(swaggerHost)
                .apiInfo(apiInfo())
                //.enable(false),是否启动Swagger
                .select()
                /*RequestHandlerSelectors配置需要扫描接口的方式，basePackage基于某个包去扫描
                any():扫描全部
                none():都不扫描
                withClassAnnotation:扫描类上的注解，需要的是一个注解的反射对象
                例：.apis(RequestHandlerSelectors.withClassAnnotation(HelloWorld.clsss))
                withMethodAnnotaion：扫描方法上的注解
                例：.apis(RequestHandlerSelectors.withMethodAnnotaion(GetMapping.class))
                */
                .apis(RequestHandlerSelectors.basePackage("com.controller"))
                //paths，过滤什么路径，扫描的时候同时也过滤一下
                .paths(PathSelectors.any())
                .build(); //创建工厂
    }

//配置Swagger信息的apiInfo，比如作者信息、项目的基本信息，实际没啥用
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("OS收银系统" +
                        "")
//                .description("用户登录之后会返回一个token，每次请求时，请将该token放置在header中")
                .description("这是一个收银系统")
                .version("1.0")
//                .contact(new Contact("红点点互动", "http://www.hdiandian.com", ""))
                .build();
    }

}


